Add detail to gdk_drag_begin docs

Mention that GTK keeps a reference while the drag
operation is ongoing.

diff --git a/gdk/gdksurface.c b/gdk/gdksurface.c
index 399e40c36890d1d9eb392ceeafe3184cf1e63801..13b0dec48d44382c318c8ebd0bbb89fc513993de 100644 (file)
--- a/gdk/gdksurface.c
+++ b/gdk/gdksurface.c
@@ -3587,6 +3587,10 @@ gdk_surface_register_dnd (GdkSurface *surface)
  * probably want to set up the drag icon using the surface returned
  * by gdk_drag_get_drag_surface().
  *
+ * This function returns a reference to the GdkDrag object, but GTK
+ * keeps its own reference as well, as long as the DND operation is
+ * going on.
+ *
  * Note: if @actions include %GDK_ACTION_MOVE, you need to listen for
  * the #GdkDrag::dnd-finished signal and delete the data at the source
  * if gdk_drag_get_selected_action() returns %GDK_ACTION_MOVE.